home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / c / datelib.exe / README < prev    next >
Text File  |  1992-03-27  |  4KB  |  83 lines
  1. ------------------------------------------------------------------------------
  2. DATLIB : Funktionen zum Manipulieren von Datum und Zeit
  3. ------------------------------------------------------------------------------
  4.  
  5. AUTOR: Klaus Rath, Wiesendamm 127,D-2000 Hamburg 60
  6. Tel.:  (49)(40)2792116
  7. EMail: - INTERNET:   Klaus(u)Rath@hh-2.maus.dbp.de
  8.                      100021.3026@compuserve.com
  9.                  via astheimer@imdm.uke-hamburg.dbp.de
  10.        - CompuServe: 100021,3026
  11.        - MausNetz:   Klaus Rath,HH-2
  12. ------------------------------------------------------------------------------
  13.  
  14. Die Funktionen in diesem Archiv sind in Standard-"C" mit dem Borland
  15. Compiler C++ (Version 2.0) geschrieben, laufen aber in gleicher Form
  16. (siehe #ifdef's) auf einer UNIX-Maschine (Nixdorf TARGON M35).
  17. Sie wurden dort ohne Probleme mit dem Standard-Compiler "cc" übersetzt.
  18.  
  19. Alle Funktionen sind hiermit als PUBLIC DOMAIN deklariert und zur
  20. beliebigen Verwendung freigegeben. Ich würde mich über Rückmeldungen
  21. freuen ...
  22.  
  23. Dieses Archiv beinhaltet keine ausführliche Dokumentation, es sei
  24. für C-Programmierer auf das "makefile" (hier für das Borland-make)
  25. und die .h-Files verwiesen. Außerdem sind alle Funktions-Quelltexte
  26. intern dokumentiert. Das "makefile" und einige Symbole in den
  27. .h-Files müssen evtl. an das Ziel-System angepaßt werden - es finden
  28. sich dort die Pfade und Programme meiner Arbeits-Systeme!!!!
  29.  
  30. Alle Funktionen beinhalten am Anfang Stringdefinitionen, die etwas
  31. merkwürdig aussehen (static char xxxx[] = "@(#).....";). Es handelt
  32. sich dabei um Kommentare für ein Versions-Kontroll-System.
  33. Wer über ein "what"-Utility verfügt, kann sich diese Kommentare auch
  34. in den Objekt- und Lib-Dateien anzeigen lassen (So ein Programm gehört
  35. zum SCCS-Paket unter UNIX. Wer's nicht hat, kann es sich in einer
  36. "kleinen" DOS-Version von mir schicken lassen oder auch per Transfer
  37. abholen - bitte Nachricht, damit mein System auf Empfang gehen kann).
  38.  
  39. Die Funktionen arbeiten generell nur mit Standardbibliotheksroutinen,
  40. Ausnahmen sind die Funktionen zum formatierten Einlesen von Datums-
  41. bzw. Zeit-Strings (*read*) - hier ist für die einfache Version eine
  42. Routine getch() vorausgesetzt, wie zum Borland Compiler dazugehört,
  43. also eine Funktion, die einen Tastendruck direkt ohne ein RETURN
  44. einliest und verarbeitet. Für diejenigen, denen unter DOS ein CURSES-
  45. Paket, gibt auch speziell dafür Versionen (wread*) - unter UNIX
  46. gehört CURSES normalerweise zum Lieferumfang (in Entwicklerversionen)
  47. und enthält ebenfalls eine getch()-Routine.
  48.  
  49. Dateiliste:
  50. ----------
  51. readme       -- Dieses File
  52.  
  53. makefile     -- Für Borland-make
  54.  
  55. datum.h      -- Symbole und Deklarationen für alle Funktionen
  56. util.h       -- Einige zusätzliche Symbole und Deklarationen
  57.  
  58. bb_tag_s.c   -- Ermittlung von "Buß- und Bettag"
  59. calcdate.c   -- Rechnen mit Datum-Strings
  60. calctime.c   -- Rechnen mit Zeit-Strings
  61. checkdat.c   -- Prüfen von Datum-Strings
  62. checktim.c   -- Prüfen von Zeit-Strings
  63. cnvtdate.c   -- Datumsformatkonvertierungen
  64. cnvttime.c   -- Zeitformatkonvertierungen
  65. diffdate.c   -- Datumsdifferenzen
  66. diffdtim.c   -- Zeitdifferenzen
  67. edgetch.c    -- Hilfsfunktion für Einlesefunktionen
  68. himmelfs.c   -- Ermittlung von "Himmelfahrt"
  69. mkdatstr.c   -- Datumsstring herstellen
  70. mktimstr.c   -- Zeitstring herstellen
  71. now.c        -- "jetzt" als Zeitstring
  72. ostern_s.c   -- Ermittlung von "Ostern"
  73. pfingsts.c   -- Ermittlung von "Pfingsten"
  74. readdate.c   -- Datum formatiert einlesen (benötigt getch()!! (s.o.))
  75. wreaddat.c   -- (CURSES-Version dazu)
  76. readtime.c   -- Zeit formatiert einlesen (benötigt getch()!! (s.o.))
  77. wreadtim.c   -- (CURSES-Version dazu)
  78. schaltj.c    -- Schaltjahrermittlungen
  79. today.c      -- "heute" in einem gewählten Format
  80. tomorrow.c   -- "morgen" in einem gewählten Format
  81. weekday.c    -- Wochentag ermitteln
  82. yesterdy.c   -- "gestern" in einem gewählten Format
  83.